home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / LIB211.ZIP;1 / SHANA.TXT < prev    next >
Encoding:
Text File  |  1993-07-23  |  3.3 KB  |  58 lines
  1. *--   SHANA.TXT
  2. Author's note about Hebrew-calendar functions:
  3. My main source for these algorithms was "The Comprehensive 
  4. Hebrew
  5. Calendar" by Arthur Spier, Third Revised Edition, Philipp Feldheim Inc.,
  6. Spring Valley, NY, 1986, but I never could have understood it without
  7. first, the fine materials given me by Dave Krajcar, ("Altsol"), of
  8. Alternative Solutions, Inc., at considerable personal expense and
  9. inconvenience, and second the simplified introduction provided by
  10. "Understanding the Jewish Calendar", by Rabbi Nathan Bushwick,
  11. Moznaim Publishing Corporation, Brooklyn, 1989.  Any mistakes in
  12. applying the algorithms are entirely mine.
  13.         The main function in importance is Roshashana ( sorry for
  14. the spelling, but the number of characters allowed in dBASE cannot
  15. exceed 10 ); I have no means of checking whether or not it works
  16. properly for periods outside the period 1900-2100.
  17.         If you try to create a calendar, you will find that using
  18. these functions repeatedly is very slow because they are set up to
  19. recalculate Rosh Hashanah from scratch on each call.  This is
  20. required by passing only the year as a parameter and returning only
  21. a date; you can easily adapt them so the date, hour and chalokim
  22. of each Molad Tishri and date of each Rosh Hashanah are saved in
  23. public variables between calls and made available to later calculations.
  24.          Note also that given the date and time of one Molad Tishri,
  25. finding the next or previous one requires only adding or subtracting
  26. 12 or 13 times the length of a lunar month.  Then, applying the
  27. dechiyoth to the date and time of the Molad Tishri will find Rosh
  28. Hashanah, and the dates of it and its predecessor can be used to find
  29. the kebiah.  Given the kebiah and the date of Rosh Hashanah, the
  30. entire calendar is known and can be constructed from code like that
  31. in the latter part of the Dat2Heb() function.
  32.         If using these functions for purposes such as figuring out
  33. when a boy is bar mitzvah, please remember some details: a child born
  34. after sundown has a Hebrew birthday matching the next civil day,
  35. anniversaries of events occurring in Adar follow special rules, and
  36. many congregations postpone the celebration if the birthday falls
  37. on the Sabbath or if the celebration would fall on certain major
  38. Sabbaths.  In addition, see the notes to the Civildate() function
  39. about Heshvan and Kislev 30, particularly in connection with
  40. Yahrzeit, determining the anniversary of a death.
  41.         I don't know Hebrew or Yiddish; my sources use different
  42. transliterations of words and I have in some cases used one form,
  43. in others another.  If my spelling, or use of words such as "Hebrew"
  44. that have on too many occasions been used as epithets, gives offense,
  45. I apologize.  Suggest more neutral terms that still convey what it
  46. is these functions do if you can; I look forward to hearing from
  47. you.  Until then, please believe that I approached this from a
  48. sense of awe at a calendar so accurate and so old, and in a spirit
  49. perhaps akin to that quoted by Rabbi Bushwick from the Gemara,
  50. Shabbos 75b, "Anyone who has the ability to calculate the motions
  51. of the heavenly bodies and does not do so is refusing to see the
  52. greatness of God's work."
  53.                                Jay Parsons
  54.                                Bernardsville, NJ
  55.                                March 27, 1993 ( Nisan 5, 5753 )
  56.  
  57.  
  58.